home *** CD-ROM | disk | FTP | other *** search
- INSTALL.TXT
- Borland C++Builder
- ===============================================================
-
- ---------------------------------------------------------------
- CONTENTS
- ---------------------------------------------------------------
-
- SECTION 0. System Requirements
- A. Minimum System Requirements
- B. Compact Installation
- C. Typical Installation
- D. Full Installation
- E. Custom Installation
- F. Installation Conflicts
- G. Individual Install Paths For All Components
-
- SECTION 1. Installation Notes
- A. Known Installation Issues
- B. Hard Drive Installation
- C. Files Available on the CD
- D. Code Signing/Authenticode
-
- SECTION 2. Changing Your System Configuration
- A. Safe Mode Boot under Windows 95
- B. VGA Mode under Windows NT
- C. Additional Notes
-
- SECTION 3. Troubleshooting Installation Error Messages
-
- SECTION 4. Registry Changes
- A. Key Names Added
- B. File Extension Associations
-
- SECTION 5. Uninstallation
- A. How to Uninstall
- B. Shared Files
- C. Files Not Removed by the Uninstall
-
- SECTION 6. Other Ways to Get Help
- A. Calling Technical Support
- B. Relevant Telephone Numbers
- C. Online Services
-
- ---------------------------------------------------------------
- SECTION 0. System Requirements
- ---------------------------------------------------------------
-
- A. Minimum System Requirements
- ---------------------------------------------------------------
- To install and run Borland C++Builder, you must meet the
- following minimum system requirements:
-
- * 24 MB RAM (32 MB recommended)
- * 80486/100 processor or better
- * Windows 95 or Windows NT (3.51 or 4.0)
- * Service Pack 5 is REQUIRED for NT 3.51 users.
- * 130 to 200 MB of free hard disk space (300 MB for
- the Client/Server Suite), subject to the
- installation options you choose and cluster
- size.
-
-
- B. Compact Installation
- ---------------------------------------------------------------
- A minimum installation of Borland C++Builder includes Borland
- C++Builder, as well as the Borland Database Engine, and is
- called the "Compact" install by the installation program.
- A compact installation of Borland C++Builder will take
- approximately 125 MB of hard disk space. To perform a compact
- installation, choose the "Compact" installation option on the
- installation options page. The files not included in this
- install are:
-
- WinSight32
- Sample Programs
- Visual Component Library Source
- Team Development Support
- Borland Shared Files
- Image Files
- Example database data
- Database Desktop
- SQL Links
- OWL support files
- MFC support files
- MS SDK Help Files
-
-
- These files may be added by running a 'Custom Install' and
- selecting only these items if you wish to add them at a later
- time.
-
- C. Typical Installation
- ---------------------------------------------------------------
- A typical installation includes the most common components
- developers need for application development. This will take
- approximately 210 MB of hard disk space. The files not
- included are:
-
- OWL support files
- MFC support files
- MS SDK Help Files
- Image Files
-
-
-
- D. Full Installation
- ---------------------------------------------------------------
- A full installation of C++Builder includes all the tools
- available, the Windows-hosted IDE, and allows development for
- 32-bit Windows. This is called the "Full" install by the
- installation program, and requires approximately 300 MB of hard
- disk space.
-
-
- NOTE: Not all options are available in all versions.
-
-
- E. Custom Installation
- ---------------------------------------------------------------
- This option lets you decide exactly which components of the
- install you wish to use, or install additional components after
- an installation has already been performed. This option starts
- out with the 'Full Install' configuration and allows you to
- remove components at will.
-
- F. Installation Conflicts
- ---------------------------------------------------------------
- To avoid potential conflicts when Setup installs system files,
- we recommend that you close down all other running applications
- before installing Borland C++Builder. To get a listing of
- applications running on your machine, either:
-
- - Under Windows 95:
- Look at the taskbar on which the Start button is located.
- OR
- Press Ctrl+Alt+Delete (once) and look at your Close Program
- list (click Cancel to exit the list).
-
- - Under Windows NT 4.0:
- Look at the taskbar on which the Start button is located.
- OR
- Press Ctrl+Alt+Delete (once), and choose Task Manager to
- see the list of programs running on your system
- (Choose File|Exit Task Manager to exit the list).
-
- - Under Windows NT 3.51:
- Double-click on the background (behind Program Manager).
- This brings up the Task List (click Cancel to exit
- the list).
-
-
- G. Individual Install Paths For All Components
- ---------------------------------------------------------------
- The paths to all of the individual setups are listed below with
- all of the packages that each product is included in. Not all
- of the listed products below are available in all versions of
- Borland C++Builder.
-
-
- 1) Borland C++Builder
- To install Borland C++Builder from the CD,
- run \SETUP\BCB\SETUP.EXE
-
- 2) Local InterBase (Client/Server and Professional packages only)
- To install InterBase and associated components,
- run \SETUP\IB5\ADOBE\SETUP.EXE
- run \SETUP\IB5\IBASE50\SETUP.EXE
- run \SETUP\IB5\IBCLNT11\SETUP.EXE
- run \SETUP\IB5\W32CLNT\SETUP.EXE
-
- 3) OLE Enterprise (Client/Server package only)
- To install OLE Enterprise,
- run \SETUP\OLEENT\OE11NT.EXE
-
- 4) InstallShield Express
- To install InstallShield Express,
- run \SETUP\ISX\ISX.EXE
-
- 5) Netscape Communicator
- To install Netscape Communicator
- run \SETUP\NETSCAPE\CC32D404.EXE
-
- 6) Internet Explorer 4.0
- To install IE 4.0
- run \SETUP\IE40\IE4SETUP.EXE
-
- ---------------------------------------------------------------
- SECTION 1. Installation Notes
- ---------------------------------------------------------------
-
- A. Known Installation Issues
- ---------------------------------------------------------------
- 1. Installation sometimes reports misleading "out of disk
- space" error message.
-
- If you install Borland C++Builder on a drive other than
- the drive on which Windows resides, check to be sure that
- you have more than 32 MB of disk space free on your Windows
- drive (usually C:). Otherwise, it is possible that the
- installation program will report that you have run out of
- disk space. This usually does not mean that you ran out of
- space on the drive on which you are installing Borland
- C++Builder. It usually means that you ran out of space on
- the Windows drive, because C++Builder must install several
- files into the Windows directory structure.
-
- Also note: If you install separate components on different
- drives on your machine, the disk space reported per drive
- and for each component may be incorrect. You should
- manually ensure that you have enough disk space for each
- component before attempting to install it.
-
- 2. Install program unable to create groups with certain
- characters.
-
- In the installation, when you get to the screen where you
- can specify the name of the program group you want to be
- created, you cannot include parenthesis '(' and ')' or
- commas ',' in the group name.
-
- 3. Problems using Symantec's Norton Navigator.
-
- If you have Symantec's Norton Desktop for Windows 95
- installed and you launch SETUP.EXE from the Navigator, you
- will see the Borland C++Builder installation begin, but
- instead of the installation displaying on the desktop, it
- will be viewable through the main view only. The
- installation is still running, but it is just not visible
- on the desktop.
-
- 4. Cannot install while uninstall running.
-
- If you attempt to run SETUP.EXE while a copy of the
- uninstall program is running, you will receive errors.
- DO NOT run the installation program while the uninstall is
- running. If you're not sure if the uninstall is running,
- follow the instructions in Section 0 F to determine what
- is running on your machine before running SETUP.EXE.
-
- 5. Qbik WinGate Engine conflict.
-
- The C++Builder installation will hang if you have the
- "Qbik WinGate Engine" service enabled. Turn off this
- service before installing the software.
-
- WinGate product information available at:
-
- http://webnz.com/qbik/index.html
- http://www.deerfield.com/wingate/support.htm
-
-
- B. Hard Drive Installation
- ---------------------------------------------------------------
- Installing from a CD-ROM may cause synchronization difficulties
- between various pieces of hardware or certain hardware drivers.
- If you suspect that your CD-ROM drive or your CD-ROM driver
- might be at fault, you can attempt a hard drive installation.
-
- To begin, copy the entire setup directory into a temporary
- directory on your local hard drive (C:\, D:\ etc.). The setup
- directory contains all the files needed for the installation.
- Once these have been successfully copied, restart your machine
- in SAFE MODE or VGA MODE by following the appropriate instructions
- in section 2 of this document, and then attempt to install the
- product by running the Setup.exe located in the Setup directory.
-
- C. Files Available on the CD
- ---------------------------------------------------------------
- Most of the files installed in your target directory by the
- SETUP.EXE program are on the distribution CD in the \IMAGE
- directory. You must use SETUP.EXE to install C++Builder, but
- you can copy files from this directory tree on the CD if any
- files are lost or damaged during or after installation.
-
- D. Code Signing/Authenticode
- ---------------------------------------------------------------
- To use C++Builder's code-signing features, you must have
- Internet Explorer 4.0 with Authenticode. This product is
- available on the CD ROM in the \SETUP\IE40 directory.
-
-
- ---------------------------------------------------------------
- SECTION 2. Changing Your System Configuration
- ---------------------------------------------------------------
- It is recommended that you change your system configuration if
- you encounter problems when installing new software.
- Windows 95 and Windows NT each have their own method, as
- follows.
-
-
- A. Safe Mode Boot under Windows 95
- ---------------------------------------------------------------
- Under Windows 95, the method for booting in a simple system
- configuration is through safe mode, a boot option provided on
- the startup menu. To boot in Safe Mode, follow the instructions
- below:
-
- 1. Shut down the machine and reboot.
- 2. Before the Windows 95 splash screen appears
- (but after the 'BEEP'), press F8.Select Safe
- Mode from the menu and press Enter.
- OR
- Windows95 will boot up in save mode if you
- hold down the <SHIFT> key after the system
- 'BEEP' and before the Windows95 splash screen.
- 3. You are now running in Windows 95 Safe Mode.
- Windows 95 informs you that you are running in a
- special diagnostic mode. Click OK and you
- will be able to continue your work.
-
- Note: Windows 95 does not recognize CD-ROM drives in
- Safe Mode. You will need to copy the files from the
- SETUP directory on the CD onto your hard drive and
- install from there (see hard drive install, section 1).
-
-
- B. VGA mode Boot under Windows NT
- ---------------------------------------------------------------
- Windows NT 3.51/4.0 use a different method for changing to a
- simple system configuration. To boot in VGA mode, follow the
- directions below:
-
- 1. Shut down the machine and reboot it.
- 2. When the OS choice menu appears, select number 2,
- Windows NT Workstation/Server [VGA mode].
- Windows NT will then boot itself in a clean mode.
-
-
- C. Additional Notes
- ---------------------------------------------------------------
- In addition to following the appropriate instructions for your
- operating system in this section, be sure to follow the other
- instructions in section 0 regarding programs running in the
- background during installation. The Safe Mode and VGA Mode
- boot processes remove extraneous drivers, but do not
- necessarily keep programs from running.
-
-
- ---------------------------------------------------------------
- SECTION 3. Troubleshooting Installation Error Messages
- ---------------------------------------------------------------
- This section contains a list of the most common error messages
- that can occur during installation. Each error message includes
- a suggested solution. If you receive errors that are not
- listed here, please contact the Installation Line at the phone
- number listed in Section 6 of this document.
-
- -2: Unable to open input file
- Check that the Source directory is specified correctly,
- and that the file being copied is located in that
- directory.
-
- -3: Unable to open output file
- Check that the Destination directory is specified
- correctly, and that the file does not already exist in
- that directory. Also make sure that you have access
- rights to write to the Destination directory.
-
- -4: Unable to write to file.
- Check the integrity of the source disk as well as the
- destination disk. Make sure that there are no errors
- on either disk
-
- -6: Memory allocation error.
- Not enough memory is currently available for the
- installation to proceed. Close down other applications
- to free memory.
-
- -9: Source and target directories conflict.
- Make sure that the source directory listed and the target
- directory listed are different.
-
- -27: Unable to create directory
- The installation program was unable to create the target
- directory specified. Please check that this directory
- does not already exist and that you have access
- privileges to that area.
-
- -38: Not enough disk space on target drive
- There is not enough hard disk space on the target drive
- specified. Free more space before attempting to
- reinstall.
-
- -46: Target file is read-only
- The file currently being written is marked as read-only
- and cannot be overwritten. Delete or rename the
- currently existing copy of this file before continuing.
-
- -401: String too long
- Your system path statement is too long. Check your path
- and shorten if possible.
-
-
- ---------------------------------------------------------------
- SECTION 4. Registry Changes
- ---------------------------------------------------------------
- The registry under Windows 95 and Windows NT is the file where
- information concerning all software added to the system is
- logged and kept for reference. You can access the registry by
- using the registry editor (regedit or regedt32 under Windows NT
- 3.51) to view and change the registry, if necessary. (There is
- almost never a reason to do this manually.)
-
- Following is a list of changes made to the registry when
- Borland C++Builder is installed.
-
-
- A. Key Names added
- ---------------------------------------------------------------
- HKEY_CURRENT_USER
- Key Name: SOFTWARE\Borland\C++Builder\3.0
- Key Name: SOFTWARE\Borland\DBD
-
- HKEY_LOCAL_MACHINE
- Key Name: SOFTWARE\Borland\C++Builder\3.0
- Key Name: SOFTWARE\Borland\BLW32
- Key Name: SOFTWARE\Borland\Database Engine
- Key Name: SOFTWARE\Borland\Borland Shared
-
-
- B. File Extension Associations
- ---------------------------------------------------------------
- These are the file extension associations kept in the registry
- under HKEY_CLASSES_ROOT:
-
- HKEY_CLASSES_ROOT\.bpg = "BCBProjectGroup"
- HKEY_CLASSES_ROOT\.bpk = "BCBPackage"
- HKEY_CLASSES_ROOT\.bpr = "BCBProjectFile"
-
- ---------------------------------------------------------------
- SECTION 5. Uninstallation
- ---------------------------------------------------------------
-
- A. How to Uninstall
- ---------------------------------------------------------------
- To uninstall C++Builder:
-
- i. Go to Start on the Task-Bar
- ii. Select 'Settings'
- iii. Select 'Control Panel'
- iv. Select 'Add-Remove' Programs
- v. Select 'Borland C++Builder'
-
- B. Shared Files
- ---------------------------------------------------------------
- C++Builder installs a number of shared files on your machine,
- during the uninstallation process the uninstaller checks to see
- if shared files are marked as being used as any other
- applications, if the system reports that there are no other
- programs using that shared file, it will prompt you asking if you
- would like it removed. This is because the OS can be incorrect
- in reporting of file dependencies. Most of the time there is no
- problem removing these shared files, and if you are uninstalling
- for the purpose of installing a new version, these files should
- be removed.
-
- If you have any problems running applications that needed these
- shared files after uninstalling C++Builder, you may find them on
- the C++Builder CD-ROM and copy them to your \WINDOWS\SYSTEM
- directory.
-
- C. Files Not Removed by the Uninstall
- ---------------------------------------------------------------
- The uninstallation program removes only the files placed on the
- system by the install. When you run C++Builder a number of files
- are created dynamically and will be leftover after the
- uninstallation. These files should be deleted.
-
- Check the remaining C++Builder directory carefully for files that
- you have created and wish to save (Usually residing in the
- 'Projects' sub-directory), then delete the CBuilder directory and
- all files therein.
-
- ---------------------------------------------------------------
- SECTION 6. Other Ways to Get Help
- ---------------------------------------------------------------
-
- A. Calling Technical Support
- ---------------------------------------------------------------
- * Have your name, pin number, product, and version number
- ready. This will speed the pace of your call.
- * If you don't have a pin number, call Borland Assist
- @ 1-800-523-7070.
- * Be sure to have read all relevant documentation. Often, you
- can avoid a long-distance or toll call by referring to the
- documentation.
- * Be prepared to describe in detail exactly what you have done
- so far while working on the problem.
- * Please be in front of your computer with the application running
- or ready to run.
- * Please be patient. We try to answer all customer questions as
- thoroughly as possible.
-
-
- B. Relevant Telephone Numbers
- ---------------------------------------------------------------
- Main Switchboard
- (408) 431-1000
-
- C++ Installation Support
- (408) 461-9144
-
- C++ Primary Assist - Usability level support
- ($2.95/minute, first minute free, 5 minute minimum charge)
- 1-888-456-2003 (charged to a credit card)
-
- C++ Developer Per Minute Incident Assist
- ($4.95/minute support, first minute free)
- 1-888-683-2378
-
- C++ Developer Incident Assist
- ($185.00)
- 1-888-683-2378
-
- TECHFAX line for receiving technical information documents:
- 1-800-822-4269 (no charge)
-
- FastFax
- 1-800-408-0001
-
- End User Sales(<10 copies)/Disk Replacement Services
- 1-800-932-9994 (no charge)
-
- Corporate Sales(>10 copies)
- 1-408-431-1064
-
- Customer Service
- (510) 354-3828
-
- Telephone Product Registration
- 1-800-845-0147
-
-
- C. Online services
- ---------------------------------------------------------------
- You can find support and information online at the following
- locations:
-
- INTERNET: Download FTP Site
- ftp.borland.com
-
- World Wide Web:
- Borland Home Page
- http://www.borland.com/
-
- Technical Support Home Page
- http://www.borland.com/techsupport/borlandcpp/
-
- Borland C++ Information Page Search Page
- http://www.borland.com/search/
-
- Bug Submission/Publication Page
- http://www.borland.com/devsupport/bugs/
-
- Patches Available Page
- http://www.borland.com/devsupport/bcppbuilder/patches.html
-
- NewsGroups:
- Server: forums.borland.com
-
- /**********************END OF FILE****************************/
-